Node / ReticulumProjects / MeshChatX.git / files / docs / en / platform-guides / android-termux.md

Displaying Raw • View rendered • Download

Tc9d1d9# Android with Termux

It's possible to run MeshChatX on Android using [Tff7b72Termux](Te6edf3https://termux.dev/). Installation is now much simpler since the wheel package includes both the server and pre-built web assets.

Tc9d1d9## Method 1: Install from Wheel (Recommended)

This is the easiest method - the wheel includes everything you need.

Tc9d1d9### Install System Dependencies

Ta5d6ff```

pkg upgrade

pkg install python

pkg install rust

pkg install binutils

pkg install build-essential

```

Tff7b72> Note: Python 3.11 or higher is required. Check with `python --version`.

Tc9d1d9### Download and Install Wheel

Download the latest wheel from the [Tff7b72releases page](Te6edf3https://github.com/Quad4-Software/MeshChatX/releases), then:

Ta5d6ff```

pip install reticulum_meshchatx-*-py3-none-any.whl

```

The wheel will automatically install all Python dependencies. Building Ta5d6ff`cryptography` may take a while on Android.

Tc9d1d9### Run MeshChatX

Ta5d6ff```

meshchatx

```

(Ta5d6ff`meshchat` is a compatibility alias for the same entry point.)

Then open your Android web browser and navigate to Ta5d6ff`http://localhost:8000`

Tc9d1d9## Method 2: Install from Source

If you need to build from source (for development or if no wheel is available for your architecture):

Tc9d1d9### Install System Dependencies

Ta5d6ff```

pkg upgrade

pkg install git

pkg install nodejs-lts

pkg install python

pkg install rust

pkg install binutils

pkg install build-essential

```

Tc9d1d9### Install pnpm

Ta5d6ff```

corepack enable

corepack prepare pnpm@latest --activate

```

Tc9d1d9### Clone and Build

Ta5d6ff```

git clone https://github.com/Quad4-Software/MeshChatX.git

cd MeshChatX

pip install uv

uv sync --group dev

pnpm install

pnpm run build-frontend

uv build --wheel

pip install dist/*.whl

```

Tc9d1d9### Run MeshChatX

Ta5d6ff```

meshchatx

```

(Ta5d6ff`meshchat` is a compatibility alias for the same entry point.)

Tc9d1d9## Configuration Notes

Tff7b72> Note: The default `AutoInterface` may not work on your Android device. You will need to configure another interface such as `TCPClientInterface` in the settings.